home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / atconfig.z / atconfig
Encoding:
Text File  |  2001-04-17  |  11.2 KB  |  261 lines
  1.  
  2.  
  3.  
  4.      AAAATTTTCCCCOOOONNNNFFFFIIIIGGGG((((1111MMMM))))     KKKK----TTTTaaaallllkkkk bbbbyyyy XXXXiiiinnnneeeetttt ((((11110000////11114444////99999999 11110000....1111))))     AAAATTTTCCCCOOOONNNNFFFFIIIIGGGG((((1111MMMM))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           /usr/etc/appletalk/atconfig - enable AppleTalk on an
  10.           interface
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           aaaattttccccoooonnnnffffiiiigggg _i_n_t_r [-_n_e_t _n] [-_o_p_t_n_e_t _n] [-_o_p_t_s_t_a_r_t _s_n -_o_p_t_e_n_d _e_n]
  14.           [-_n_o_d_e _d] [-_s_t_a_r_t _s_n -_e_n_d _e_n] [-_f] [-_D]
  15.           aaaattttccccoooonnnnffffiiiigggg ----cccclllleeeeaaaarrrr
  16.           aaaattttccccoooonnnnffffiiiigggg ----aaaattttttttaaaacccchhhh _i_n_t_r
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.           The _a_t_c_o_n_f_i_g command enables AppleTalk on an interface.  It
  20.           is similar in function to _i_f_c_o_n_f_i_g(1m).  When _a_t_c_o_n_f_i_g is
  21.           run, the interface uses the Apple Address Resolution
  22.           Protocol (AARP) to determine its net and node number.  When
  23.           run on the loopback _l_o_0, _a_t_c_o_n_f_i_g sets the net and node of a
  24.           local pseudo-network.  Specifying a _i_n_t_r of "default" will
  25.           configure the first interface in the ifaddr list.  All
  26.           numeric arguments may be specified in hexadecimal by
  27.           prepending them with a 0x.  The flags are defined as
  28.           follows:
  29.  
  30.           ----nnnneeeetttt nnnn
  31.                Specifies that atconfig will use net number _n. If a net
  32.                number is specified, and it conflicts with net
  33.                information gathered from RTMP packets, EINVAL will be
  34.                returned.  A net number must be specified when
  35.                configuring the loopback interface (lo0).
  36.  
  37.           ----ooooppppttttnnnneeeetttt nnnn
  38.                Specifies that atconfig will use net number _n, net
  39.                range _n-_n. This differs from ----nnnneeeetttt in that if there is
  40.                another router using a different net number, no error
  41.                message will be returned.  If ----ooooppppttttssssttttaaaarrrrtttt and ----oooopppptttteeeennnndddd are
  42.                used, they specify a network range to be used only if
  43.                it does not conflict with an existing router.  These
  44.                modes are  useful for configuring K-Talk on a network
  45.                where other AppleTalk routers exist, but are not
  46.                reliable.
  47.  
  48.           ----nnnnooooddddeeee dddd
  49.                This specifies that AARP will begin trying to acquire a
  50.                node number at node _d. If the node number is not
  51.                specified, it defaults to 128 (0x80).  It does not
  52.                specify the actual node number obtained, only where to
  53.                start.
  54.  
  55.           ----ssssttttaaaarrrrtttt ssssnnnn ----eeeennnndddd eeeennnn
  56.                This specifies the start and end of the network range.
  57.                These arguments are only used when you want to set up
  58.                an extended network range (more than one node number).
  59.                If the start and end are not specified, _a_t_c_o_n_f_i_g
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 5/15/100)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      AAAATTTTCCCCOOOONNNNFFFFIIIIGGGG((((1111MMMM))))     KKKK----TTTTaaaallllkkkk bbbbyyyy XXXXiiiinnnneeeetttt ((((11110000////11114444////99999999 11110000....1111))))     AAAATTTTCCCCOOOONNNNFFFFIIIIGGGG((((1111MMMM))))
  71.  
  72.  
  73.  
  74.                defaults to the range already in use on the network (if
  75.                there are other routers), or to provisional mode there
  76.                are no other routers.  In provisional mode, network
  77.                range 65280-65534 (the provisional range) is used.
  78.                This will allow K-Talk to communicate with other
  79.                AppleTalk devices on an Ethertalk network with no
  80.                routers.
  81.  
  82.           ----ffff   specifies that _a_t_c_o_n_f_i_g will use the specified _n_e_t
  83.                number for the local pseudo-net even if it already
  84.                appears in routing tables.  This option is used to
  85.                maintain single numbers for the pseudo-net when there
  86.                are routers that do not properly process delete-route
  87.                packets.
  88.  
  89.           -_D   causes debugging information to be printed first when
  90.                the flag is encountered in the command line, and again
  91.                when the arguments have been processed.  It is mostly
  92.                used to check argument parsing.
  93.  
  94.           ----cccclllleeeeaaaarrrr
  95.                is used to reset all AppleTalk kernel information.  It
  96.                should be done only when all AppleTalk services have
  97.                been halted (with an atinit halt).  It will clear all
  98.                interface configuration information, as well as the
  99.                AARP and routing tables. After clearing the interface,
  100.                you should wait for 10 seconds to allow the routing
  101.                tables to be rebuilt before running any additional
  102.                _a_t_c_o_n_f_i_g commands.  The main use of the ----cccclllleeeeaaaarrrr option
  103.                is to clear a configuration when you plan to switch
  104.                your network configuration.
  105.  
  106.           ----aaaattttttttaaaacccchhhh
  107.                is used on Streams implementations (currently, only
  108.                Solaris) to make an interface ``known'' by the
  109.                AppleTalk Protocol, but does not configure it.  This is
  110.                used to allow routing packets through on an interface
  111.                in order to determine the prefered net range.  On these
  112.                systems, an interface will not show up in the _a_t_i_n_f_o(1)
  113.                list until it has either been _a_t_t_a_c_h_e_d or configured.
  114.  
  115.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  116.           atconfig: old-style arguments.  New command would be: ...
  117.                     The arguments passed to _a_t_c_o_n_f_i_g were in the
  118.                     format of old versions of _a_t_c_o_n_f_i_g A new-style
  119.                     command line will be printed to ease conversion.
  120.  
  121.           atconfig: permission denied
  122.                     You must be root to configure interfaces.
  123.  
  124.           atconfig: socket: ...
  125.  
  126.  
  127.  
  128.      Page 2                                         (printed 5/15/100)
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.      AAAATTTTCCCCOOOONNNNFFFFIIIIGGGG((((1111MMMM))))     KKKK----TTTTaaaallllkkkk bbbbyyyy XXXXiiiinnnneeeetttt ((((11110000////11114444////99999999 11110000....1111))))     AAAATTTTCCCCOOOONNNNFFFFIIIIGGGG((((1111MMMM))))
  136.  
  137.  
  138.  
  139.                     _a_t_c_o_n_f_i_g could not open an AppleTalk socket.  This
  140.                     usually means that AppleTalk is not installed in
  141.                     the kernel.
  142.  
  143.           atconfig: invalid interface xx
  144.                     The specified interface is not valid.  Use
  145.                     _a_t_i_n_f_o(1) to get a list of the interfaces.
  146.  
  147.           atconfig: interface xx already configured
  148.                     The interface is already configured.  You must
  149.                     clear it with aaaattttccccoooonnnnffffiiiigggg ----cccclllleeeeaaaarrrr before you can
  150.                     configure it again.
  151.  
  152.           atconfig: no net number specified on net with no other routers
  153.                     This means that you did not specify a net number
  154.                     on a network that does not have any other
  155.                     AppleTalk routers.  You need to specify a network
  156.                     number with a -net flag.  To do this, edit
  157.                     /_u_s_r/_e_t_c/_a_p_p_l_e_t_a_l_k/_s_e_r_v_i_c_e_s and change the
  158.                     aaaattttccccoooonnnnffffiiiigggg line for the interface.
  159.  
  160.           atconfig: illegal parameters start=x net=y end=z.  startnet <= net <= endnet
  161.                     One of the parameters startnet, endnet, or net is
  162.                     invalid.  Usually means that you set a net number
  163.                     that was not within the existing network range.
  164.                     To fix this, edit /_u_s_r/_e_t_c/_a_p_p_l_e_t_a_l_k/_s_e_r_v_i_c_e_s and
  165.                     remove the conflicting -net argument from the
  166.                     aaaattttccccoooonnnnffffiiiigggg line for the interface.
  167.  
  168.           atconfig: SIOSETADDR failed (xx): ...
  169.                     The ioctl to set the address failed.  Usually this
  170.                     means that the parameters specified conflict with
  171.                     configurations already existing on the network.
  172.  
  173.           atconfig: K-Talk kernel modules not loaded
  174.                     If you are running a system with loadable kernel
  175.                     modules, the loading of the kernel modules failed.
  176.                     Check for error messages from atalkmodload.  If
  177.                     you are not running a system with loadable kernel
  178.                     modules, then you are running a non-AppleTalking
  179.                     kernel.  Use mmmmkkkkkkkkeeeerrrrnnnneeeellll to build an AppleTalking
  180.                     kernel, copy it to /, and reboot.
  181.  
  182.      CCCCAAAAVVVVEEEEAAAATTTTSSSS
  183.           The first interface to be successfully configured becomes
  184.           your default interface.  This is the interface where
  185.           AppleTalk services are registered.
  186.  
  187.      FFFFIIIILLLLEEEESSSS
  188.  
  189.  
  190.  
  191.      PPPPaaaaggggeeee 3333                                         ((((pppprrrriiiinnnntttteeeedddd 5555////11115555////111100000000))))
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.      AAAATTTTCCCCOOOONNNNFFFFIIIIGGGG((((1111MMMM))))     KKKK----TTTTaaaallllkkkk bbbbyyyy XXXXiiiinnnneeeetttt ((((11110000////11114444////99999999 11110000....1111))))     AAAATTTTCCCCOOOONNNNFFFFIIIIGGGG((((1111MMMM))))
  199.  
  200.  
  201.  
  202.           /usr/etc/appletalk/services   The file where _a_t_c_o_n_f_i_g
  203.                                         commands are placed.
  204.  
  205.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  206.           atinfo(1)
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.      Page 4                                         (printed 5/15/100)
  258.  
  259.  
  260.  
  261.